home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_1
/
dbill52.zip
/
DOORBILL.DOC
< prev
next >
Wrap
Text File
|
1992-05-12
|
30KB
|
704 lines
DOORBILL 5.2
------------
One of the MicroNet Collection
of Multi-BBS Doorware programs
for systems supporting
PCBOARD.SYS, USERS.SYS, DOOR.SYS, CALLINFO.BBS
USERINFO.DAT, SFDOORS.DAT, DORINFOx.DEF, or CHAIN.TXT
Written and Supported By:
Ted Freeman
Rt. 1, Box 689
Tazewell, TN 37879
(c) Copyright 1990-92
All Rights Reserved
DOORBILL v5.2 - Users Guide - Page i
C O N T E N T S
=================
Warranty ............................................ 1
Copyright notice .................................... 1
Distribution ........................................ 1
Description ......................................... 1
Registration ........................................ 2
DBUTIL .............................................. 3
Categories (Add/Edit) ............................. 3
Doors (Add/Edit) .................................. 4
Menu Configuration ................................ 7
Post Bulletin ..................................... 7
Sort Door Listings ................................ 7
DoorBill Configuration Files ........................ 8
DoorBill Batch File ................................. 9
Door Operation Information .......................... 10
Miscellaneous Notes ................................. 11
Order Form .......................................... 12
DOORBILL v5.2 - Users Guide - Page 1
WARRANTY
--------
This product is provided "as is" without warranty of any kind. The entire
risk as to the results and performance of the program is assumed by you.
Futhermore, the author does not warrant, guarantee, or make any other
representations regarding the use of, or the results of the use of the
program, and you rely on the program and results solely at your own
risk. The author cannot and will not accept responsibility for system
damage, loss of profit, or any other special, consequential or incidental
damages resulting from the use or inability to use this product.
COPYRIGHT
---------
DOORBILL, Copyright (c) 1990-1992 by Ted Freeman, is being distributed as
Shareware. Under this concept you may use the SHAREWARE (unregistered)
version for a reasonable period of time for evaluation after which you
must either register your copy or discontinue usage.
DISTRIBUTION
------------
This program is being distributed via the SHAREWARE concept and as such,
may be copied freely with the following restrictions:
* The program must be supplied in it's original
unmodified form, including documentation.
* DOORBILL may not be distributed as part of any
commercial application or service without the
express, written consent of the author.
* Vendors of Shareware/Public Domain software may
not distribute this program without the express,
written consent of the author, unless said Vendor
has been approved by the Association of Shareware
Professionals (ASP).
DESCRIPTION
-----------
DOORBILL is a versatile Door manager that allows you to add or delete
Door programs to your BBS with relative ease. DOORBILL features many
options such as applying level restrictions to all Categories of Doors
as well as to each individual Door. In addition you may lock any Door
based solely on the caller's baud rate! DOORBILL options include the
viewing of your Doors/Games Bulletins online, running the included
utility program while the Sysop is in local mode, creating a Bulletin
listing of all your Door Categories and Doors available. You may add,
delete, move, sort, and insert Categories and Doors with just a couple
of keystrokes. DOORBILL is compatible with PCBoard v14.x, Wildcat!,
Spitfire, RBBS, QBBS, Remote Access, WWIV, UltraBBS, Telegard, GAP,
TriTel and others.
DOORBILL v5.2 - Users Guide - Page 2
REGISTRATION
------------
DOORBILL represents many hours of programming and the author
deserves just compensation for his time, efforts and expertise.
If you find this program to be of some value and you continue
to use it on your BBS system, you must return the registration
form provided along with the registration fee. Registration
entitles you to free upgrades via modem from MicroNet's Support
Conference. Payments should be made in the form of a check or
money order (do NOT send cash!). Foreign orders must be in U.S.
funds drawn on a U.S. bank.
Online registration with Visa or Mastercard is available via our
Credit Card Door on the following systems:
MicroNet: (615) 626-1620 ULTRA Livewire: (609) 235-5297 MNP5
(TN) (NJ) (609) 866-2551 HST DS
(609) 727-3246 MNP5
Note: If you register online your registration number will be
posted via private message on the BBS you registered
DoorBill with. If you register by mail your number will
be posted on MicroNet.
-----------------------------
DOORBILL v5.2 - Users Guide - Page 3
DBUTIL.EXE
If you are running multiple nodes and wish to have different names for the
.DAT and .CNF files, you must use the same syntax as when calling DoorBill
itself. For example, if you wish to call node one's files DBILL1.CNF and
DBILL1.DAT, your command line when invoking DBUTIL.EXE would be:
DBUTIL CNF:DBILL1.CNF DAT:DBILL1.DAT
The default filenames are DOORBILL.CNF and DOORBILL.DAT.
Categories (Add/Edit)
DBUTIL.EXE is where you enter all data for your doors. It is very simple
to use but we'll take a walk through the prompts just to make sure. First,
we select "Categories (Add/Edit)". You may use the arrow keys or just type C.
Field 1: BLT Path [C:\PCB\GEN\BLT1 ] <- Optional Field
The BLT field is for those of you who wish to post a Bulletin of all
your Door Categories and their associated Doors. This filename must be
limited to 7 characters or less because a 'G' will be appended on the
ANSI bulletin. (See 'POST BULLETIN' q.v.)
Field 2: BLT Menu [C:\PCB\GAMES\BLT ] <- Optional Field
Enter full Path/Filename for your DOORS BLT file (this is the menu of
bulletins you create with The Draw or whatever). Both ASCII (BLT) and
ANSI graphics (BLTG) bulletins are supported but not PCBoard @X codes.
Limit the filename to 7 characters because DoorBill appends a G for the
ANSI file. Do not use an extension! Leave this field blank to disable.
Field 3: BLT.LST [C:\PCB\GAMES\BLT.LST ] (PCBoard) <- Optional Field
Field 3: BLT.LST [C:\PCB\GAMES\LISTING.BLT ] (Others) <- Optional Field
PCBoard:
Enter the full Path/Filename for your DOOR/GAMES BLT.LST file. If you are
using either PCBOARD.SYS or USERS.SYS in the .CFG, the file must be
in the PCBoard BLT.LST format. Leave blank to disable.
Others:
The format for this file is ASCII/ANSI filenames. For example:
D:\DOORS\QUIZARD\QUIZARD.BLT*D:\DOORS\QUIZARD\QUIZARDG.BLT
Note the * separating the two filenames. The line number in this file
corresponds to the number of the bulletin on the menu. For example,
the menu (from Field 2) lists:
1. Tradewars Rankings
2. <- No #2 bulletin
3. Quizard Mt. Top Ten
then this file would look something like this.
D:\DOORS\TWBLT.ASC*D:\DOORS\TWBLT.ANS
<- enter a SPACE here
D:\DOORS\QUIZARD.BLT*D:\DOORS\QUIZARDG.BLT
If the caller enters 2, 'Bulletin not found!' will be displayed.
If you have an ASCII bulletin but no ANSI, enter it as:
D:\DOORS\QUIZARD.BLT* <- Asterisk last char
If you have an ANSI bulletin but no ASCII, enter is as:
*D:\DOORS\QUIZARDG.BLT <- Asterisk first char
Field 4: G]oodbye [Y] <- Optional Field
Enter an N if you do not want your users to be able to logoff from DoorBill.
This field will default to Y.
DOORBILL v5.2 - Users Guide - Page 4
Field 5: Log? [Y] <- Optional Field
Enter an N if you do not wish DoorBill to create a log file. This field
defaults to Y and will create DOORBILL.LOG. The log will contain the
caller's name, door opened, time, and date.
Field 6: Auto-ANSI? [Y]
This option toggles automatic ANSI detection. If this is on (default),
DoorBill will determine if the remote system has ANSI capabilities and
if so, will display the Menus using extended ASCII characters. If this
is set to 'N' or ANSI is not detected, the Menus use keyboard characters.
Whether color is displayed or not is determined by the BBS setting.
Field 7: 1st Lock [00:00] <- Optional Field.
If you wish to keep users out during certain time periods of the day,
(such as before an event), enter a time in this field. The lock/unlock
use the 24 hour clock so be careful when entering the times. For example
if you want to lock DoorBill at 11:30 P.M. and unlock it at 12:30 A.M.,
you would enter 23:30 in this field and 00:30 in the unlock field.
Field 8: Unlock? [00:00] <- Optional Field.
Time you wish to unlock DoorBill.
Field 9: 2nd Lock [00:00] <- Optional Field.
Same as Field 7.
Field 10: Unlock? [00:00] <- Optional Field
Same as Field 8.
Lines 4 - 24: LEVEL
Title for Menu 1: [Trivia and Word Games ] [ 30]
Title for Menu 2: [Space and War Games ] [100]
Title for Menu 3: [Miscellaneous ] [ 50] Etc.
DoorBill allows you to set a security level for each category. In the above
example, a caller with level 50 would see only the 1st and 3rd entries
but for him they would be numbered 1 and 2. He will never be aware there is
another category there. A caller with level 100 would see all 3 entries.
When the cursor is in one of the 20 Title fields, F2 and F3 are active for
inserting and deleting entries. Press the F1 function key to save your data.
Doors (Add/Edit)
----------------
After saving your data in the Categories screen, you will see a menu of the
categories you just entered. The first entry will be highlighted. Just hit
enter to select the highlighted item or use the arrow keys to move the
highlighted bar. Using the example above, that would be Trivia and Word Games.
Now you will see "Enter Data for New Door" highlighted. Select this any
time you wish to add a new door.
Follow the example below and you should have no trouble getting your doors
entered. This is essentially just like you would write a regular Door batch
file.
Menu Name [Quizard's Mountain ]
This is the name of the Door as it will appear on the DoorBill menu.
DOORBILL v5.2 - Users Guide - Page 5
Door Path [F:\DOORS\QM ] <- Must exist. DoorBill checks!
This is the PATH ONLY to the Door's directory. Do not include the filename.
Door Desc [Trivia and role playing all 'roled' into one! ]
This is a description of the Door as it will appear on DoorBill's menu.
Prolog [C:\BULLETIN\BULL1 ]
DoorBill will display an ANSI or ASCII screen before the Door loads if
there is a valid PATH and FILENAME entered here. This is handy for
displaying 'Donation' screens for unregistered Doors, etc. If this field
is blank or has an invalid path/filename, DoorBill will ignore it. If you
have both ANSI and ASCII screens, enter the ASCII filename only. DoorBill
will look for the ASCII filename plus a G for the ANSI file. For example,
C:\BULLETIN\BULL1 <- ASCII file, must be no more than 7 chars.
C:\BULLETIN\BULL1G <- ANSI version
C:\BULLETIN\BULL1.EXT <- Ignored because of the extension.
Epilog [C:\BULLETIN\BULL2 ]
Same as above except the file is sent AFTER the Door ends and before
DoorBill reloads.
Minimum Security to Access Door? [030]
Show Door to callers under level 030 [Y]
If you put Y this door will be shown to everyone, however those below
level 30 will NOT be allowed into this door. If you put N then it will
only be listed on the menu for level 30 and above.
Baud Rates Allowed 3[N] 12[Y] 24[Y] 48[Y] 96[N] 19.2[N] 38.4[N]
In this example, anyone calling at baud rates of 300, 9600, 19200 and 38400
would receive the message:
'This Door is not available at your current baud rate.'
and would be returned to the menu. The other baud rates would be allowed to
access the Door.
1st Lock: [00:00] UnLock: [00:00] 2nd Lock: [00:00] UnLock: [00:00]
You have the option of locking any Door during 2 different time periods of
the day. These fields use the 24 hour clock (1 P.M. is 13:00, NOT 01:00).
1: [QUIZARD QUIZARD.CFG ]
. . .
. . .
15: [ ]
Enter any and all information it takes to run the Door. This information
is written to a batch file 'on-the-fly' when a Door is selected from the
DoorBill menu.
Conversion (C/D/N/P/R/S): [D]
DoorBill will write a conversion file for the following formats:
C = CALLINFO.BBS (Wildcat!) D = DORINFO1.DEF (RBBS/QBBS/RA)
N = CHAIN.TXT (WWIV) P = PCBOARD.SYS (For non-PCB systems)
R = DOOR.SYS (GAP 52 Line) S = SFDOORS.DAT (Spitfire)
NOTE: For non-PCBoard systems, the P conversion creates PCBOARD.SYS, USERS,
and PCBOARD.DAT. This conversion is ignored on PCBoard systems.
DOORBILL v5.2 - Users Guide - Page 6
Multi-Node? [Y]
Place an N here if the Door is not accessible by more than one Node at a
time. DoorBill will 'lock' that Door while someone is in it and will
display a message to all others that the Door is currently being used.
Time Limit? [000]
DoorBill allows you to limit the callers time allowed in each Door. This
field will accept the time in minutes ranging from 000 to 999. If the
caller has less time left on the BBS than is specified here, his time
in the Door will be adjusted to his actual time left.
DTE [00]
Requirements for using this field: HST modem, port is locked at 9600 or
above, this door cannot support the locked baud rate. Once all 3 criteria
have been met, enter the first 2 numbers of the locked baud rate. For
example, the port is locked at 38,400 - enter 38. For 9600 - enter 96.
---------------------------------
If you wish to MOVE the Door to another Category, hit F4 and you will be
shown a list of your active Categories and prompted for the number of the
Category you wish to MOVE the Door to.
When the cursor is on one of the 15 Command Line fields, F1 and F2 become
active for inserting and deleting. You MUST hit F1 to save your data. Leaving
this screen via F9 or ESC will NOT save the data.
DOORBILL v5.2 - Users Guide - Page 7
Menu Configuration
------------------
DoorBill features a versatile menu configuration utility which allows you to
customize the appearance of both the Category and the Door Menu screens. You
may choose from 20 border styles, 7 Background colors and 32 Foreground
colors (the upper 16 are blinking colors). Customizing your menus is simply
a matter of pressing a few keys (Arrows, Tab, @, ESC) until you arrive at
one that suits your tastes. The available keys are displayed on-screen at
all times.
Post Bulletin
-------------
This option allows you to create a Bulletin file of all your Door
Categories and their associated Doors. Both ASCII and ANSI Bulletins
are created. The Bulletin will list all Categories and Doors so if you
have entries that you don't want everyone to see you will need to edit
those out of the Bulletin. The Bulletin is not created automatically.
You must select 'Post Bulletin' from DBUTIL's Main Menu. If you leave
the BLT Path field blank (that's field 1 in the Categories screen) and
select 'Post Bulletin', two files will be created in the DoorBill
directory with filenames of 'DOORBLT' and 'DOORBLTG'.
Sort Door Listings
------------------
This option sorts all Door listings in all Categories into alphabetical
order.
DOORBILL v5.2 - Users Guide - Page 8
DOORBILL.CFG
------------
NOTE: See MISCELLANEOUS NOTES for info on using Environment variables
in DOORBILL.CFG
Configuration file when using USERS.SYS:
(Also accesses PCBOARD.SYS, PCBOARD.DAT, USERS, and CALLERx)
C:\PCB\USERS.SYS <- Path/filename to USERS.SYS
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
Configuration file when using PCBOARD.SYS:
(Also accesses PCBOARD.DAT, USERS, and CALLERx)
C:\PCB\PCBOARD.SYS <- Path/filename to PCBOARD.SYS
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
Configuration file when using DOOR.SYS:
C:\PCB\DOOR.SYS <- Path/filename to DOOR.SYS
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
Configuration file when using DORINFO1.DEF:
C:\BBS\DORINFO1.DEF <- Path/filename to DORINFO1.DEF.
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
Configuration file when using CALLINFO.BBS:
C:\BBS\CALLINFO.BBS <- Path/filename to CALLINFO.BBS
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
Configuration file when using USERINFO.DAT:
C:\BBS\USERINFO.DAT <- Path/filename to USERINFO.DAT
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
Configuration file when using SFDOORS.DAT:
C:\BBS\SFDOORS.DAT <- Path/filename to SFDOORS.DAT
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
Configuration file when using CHAIN.TXT:
C:\BBS\CHAIN.TXT <- Path/filename to CHAIN.TXT
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
Configuration file when using GTUSER.BBS:
C:\BBS\GTUSER.BBS <- Path/filename to GTUSER.BBS
MicroNet PCBoard <- Name of BBS
Ted <- Sysop's first name
Freeman <- Sysop's last Name
1 <- COM port number (defaults to 1)
2 <- Node number (defaults to 1)
DOORBILL v5.2 - Users Guide - Page 9
DOORBILL BATCH FILE
-------------------
This is the batch file whose name is entered in PCBSETUP or the corresponding
utility for your BBS. It should reside in your default BBS directory. Leave
this AS IS except for changing the paths. The 'x' in each line should be
replaced with the NODE number (single node systems use 1).
ECHO OFF
:START
C:
CD\PCB\DOORBILL
IF EXIST DBRUNx.BAT DEL DBRUNx.BAT
IF EXIST ENDBILL.x DEL ENDBILL.x
DOORBILL DOORBILL.CFG <-- (see note 2 below)
IF EXIST ENDBILL.x GOTO EXIT
IF NOT EXIST DBRUNx.BAT GOTO EXIT
CALL DBRUNx <- where x = node number
GOTO START
:EXIT
C:
CD\PCB
BOARD
1: DoorBill requires the presence of BRT71EFR.EXE either in the same
directory as DoorBill or accessible via PATH.
2: Doorbill supports COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ add the IRQ
number after the configuration filename. For example, to use IRQ 5:
DOORBILL DOORBILL.CFG /5
You may also use an Environment variable here. If you have previously
SET IRQ=5 either in your BBS batch file or your AUTOEXEC.BAT, you
may invoke DoorBill with the command:
DOORBILL DOORBILL.CFG /%IRQ%
If your BBS has more than one node you may run multiple .DAT and
.CNF files from the same directory. Just pass the filename when
calling DoorBill. For example, on a 2 node system you might call
the files DBILL1.CNF, DBILL2.CNF, DBILL1.DAT, and DBILL2.DAT. For
Node 1 your command line would be:
DOORBILL DOORBILL.CFG CNF:DBILL1.CNF DAT:DBILL1.DAT
and for Node 2:
DOORBILL DOORBILL.CFG CNF:DBILL2.CNF DAT:DBILL2.DAT
If you do not specify the CNF: or DAT: parameters, they will default
to DOORBILL.CNF and DOORBILL.DAT.
DOORBILL v5.2 - Users Guide - Page 10
DOOR OPERATION
--------------
F3 - Toggles the printer On/Off. Value is passed to PCBoard.
F4 - Toggles the Page Bell On/Off. Value is passed to PCBoard.
F5 - DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
F7 - Toggles the Caller Alarm On/Off. Value is passed to PCBoard.
F8 - Returns the caller involuntarily to the BBS.
F9 - Toggles the local display On/Off. Value is passed to PCBoard.
F10 - Activates SysOp CHAT mode within the DOOR.
ESC - Deactivates CHAT mode. DOOR is resumed.
HOME - HELP key for status line options.
UP - Allows the SysOp to give the caller extra time while in the DOOR.
DN - Allows the SysOp to subtract time from the caller.
NOTE: Time and Level changes are passed to the BBS when using USERS.SYS,
SFDOORS.DAT, CALLINFO.BBS, USERINFO.DAT or DOOR.SYS.
ALT-N - SysOp next on toggle. (available only with USERS.SYS or
PCBOARD.SYS). Value is passed to PCBoard.
ALT-X - Exit to DOS after current caller logs off. (Available only
with USERS.SYS or PCBOARD.SYS). Value is passed to PCBoard.
DOORBILL v5.2 - Users Guide - Page 11
MISCELLANEOUS NOTES
-------------------
* The Printer, Page Bell, and Call Alarm toggles as well as any
changes in caller's Time or Level are written to DOOR.SYS,
CALLINFO.BBS and SFDOORS.DAT.
* PCBoard's Call Waiting screen and USERS are only updated when using
the USERS.SYS file and not when using PCBOARD.SYS.
* DoorBill creates it's own time keeping file called DBILLx.TIM.
If for some reason this doesn't get deleted, it could cause problems
for the next caller (like a Time Expired message!). To prevent this
simply add the following in the batch file that runs the BBS (NOT
DOORBILL'S BATCH FILE!). For PCBoard this is usually BOARD.BAT.
IF EXIST C:\DOORBILL\DBILLx.TIM DEL C:\DOORBILL\DBILLx.TIM
Of course you would substitute your own path to the DoorBill dir.
Substitute the Node number for the x.
* GT Sysops please note that the COM port number must be included
on line 5 of the configuration file! When assigning security levels
for the Categories and Doors, Doorbill assigns levels as follows:
(9 to 0) = (53 to 62)
(Z to A) = (27 to 52)
(z to a) = (1 to 26)
* You may use Environment variables to pass the Path of your system
file to DoorBill. DoorBill will recognize the variables PCBDRIVE
and PCBDIR. Either in your BBS batch file or in AUTOEXEC.BAT,
place the following two statements:
SET PCBDRIVE=C:
SET PCBDIR=\BBS
Substitute your actual Drive and/or BBS subdirectory. Then in
your DOORBILL.CFG file instead of hard coding it as
C:\BBS\DOOR.SYS
you would use the Environment variables thusly
%PCBDRIVE%%PCBDIR%\DOOR.SYS
This method allows you to use just one DOORBILL.CFG no matter
which Node is accessing DoorBill.
* If your BBS can utilize DOS error levels, DoorBill returns an
error level of 1 for Wildcat! systems and 62 for all others when
the caller logs off from within DoorBill.
Normal usage in a batch file would be:
IF Errorlevel == 62 GOTO Label
M I C R O N E T D O O R R E G I S T R A T I O N F O R M
TO: MicroNet Date___/___/___
Rt. 1, Box 689
Tazewell, TN 37879
(Please use capitalization and punctuation where necessary.)
FROM: SysOp Name: _______________________________________________
BBS Name: _________________________________________________
Address: __________________________________________________
City: ______________________ State: __________ ZIP: _______
Voice: ( ) _________________ BBS: ( ) _________________
BBS Software: _____________________ BBS Hours: ____________
Baud Rates:________________________
SOFTWARE VERSION PRICE
-------- ------- -----
DoorBill .......................... 5.2 ................. $30.00 __
4 Square .......................... 1.4 ................. $20.00 __
Eliminate ......................... 4.6 ................. $20.00 __
Peg Jump .......................... 1.5 ................. $20.00 __
Quizard's Mountain ................ 4.3 ................. $25.00 __
Real-Time Battleship .............. 1.2 ................. $25.00 __
Real-Time Backgammon .............. 1.3 ................. $25.00 __
Real-Time Checkers ................ 1.8 ................. $25.00 __
Real-Time Chess ................... 1.5 ................. $25.00 __
Real-Time Connect 4 ............... 1.1 ................. $25.00 __
Real-Time Othello ................. 1.3 ................. $25.00 __
Total Recall....................... 3.6 ................. $20.00 __
(Current versions as of 05-06-92)
_____
(TN residents add 7% tax) _____
Total $______
F E E D B A C K
---------------
I learned of DOORBILL from:
[ ] - A Friend [ ] - Computer Club
[ ] - BBS [ ] - Compuserve
[ ] - GEnie [ ] - Other
COMMENTS: _____________________________________________________
_______________________________________________________________
_______________________________________________________________
_______________________________________________________________
_______________________________________________________________